使用空节点 (Empty Node) 节点

空节点 (Empty Node) 节点可用于分组节点并设置其子节点的属性值。空节点 (Empty Node) 节点没有可视呈现,除了具有透明背景以外也没有任何功能,但可以是其他节点的父节点。空节点 (Empty Node) 节点没有任何特定的属性。

例如,使用空节点 (Empty Node) 节点可以:

空节点 (Empty Node) 是一个您可以在其中放入其他任何节点的节点,它具有以下特性:

空节点 (Empty Node) 没有固有的布局特征。空节点 (Empty Node) 不会重设自己的子节点大小,但会将它们放在您指定的位置。空节点 (Empty Node)布局高度 (Layout Height)布局宽度 (Layout Width) 属性的默认值为 0,但默认会拉伸,以占据它的子节点所需要的全部空间。

您可以使用水平对齐 (Horizontal Alignment)垂直对齐 (Vertical Alignment) 属性,仅在指定了空节点 (Empty Node)布局高度 (Layout Height)布局宽度 (Layout Width) 属性之后对齐空节点 (Empty Node) 的子节点。

创建空节点 (Empty Node) 节点

要创建空节点 (Empty Node) 节点:

  1. 工程 (Project)按下 Alt 并右键点击要在其中创建空节点 (Empty Node) 节点的那个节点,然后选择 3D 空节点 (Empty Node 3D)2D 空节点 (Empty Node 2D)
    请注意,只能在 3D 节点内创建 3D 节点,只能在 2D 节点内创建 2D 节点。
  2. 工程 (Project) 中,将项添加到空节点 (Empty Node) 节点。
    例如,如果创建了 3D 空节点 (Empty Node 3D) 节点,请添加球体 (Sphere) 节点,如果创建了 2D 空节点 (Empty Node 2D) 节点,请添加图像 (Image) 节点。
  3. (可选)工程 (Project) 中,选择空节点 (Empty Node) 节点,然后在属性 (Properties) 中点击 并设置您希望它的所有子节点继承的属性。

设置2D 空节点 (Empty Node 2D) 节点的外观

要设置 2D 节点的外观:

在 API 中使用 3D 空节点 (Empty Node 3D) 节点

要使用 API 创建 3D 空节点 (Empty Node 3D) 节点:

//创建一个名为 Empty3D 的 3D 空节点 (Empty Node 3D)
EmptyNode3DSharedPtr emptyNode = EmptyNode3D::create(domain, "Empty3D");
        
//创建 3D 空节点 (Empty Node 3D) 并为其添加一个立方体
ModelSharedPtr cube = Model::createCube(domain, "Cube", 1.0f, KanziThemeOrange);
emptyNode->addChild(cube);

有关详细信息,请参阅 API reference中的 EmptyNode3D 类。

在 API 中使用 2D 空节点 (Empty Node 2D) 节点

要使用 API 创建 2D 空节点 (Empty Node 2D) 节点:

//创建一个名为 Empty2D 的 2D 空节点
EmptyNode2DSharedPtr empty2D = EmptyNode2D::create(domain, "Empty2D");

//创建 2D 空节点并为其添加一幅图像
ImageSharedPtr image = Image::create(domain, "Image");
image->setTextureResourceID(ResourceID("DefaultTexture"));
empty2D->addChild(image);

有关详细信息,请参阅 API reference中的 EmptyNode2D 类。

空节点 (Empty Node)属性类型和消息

要查看 空节点 (Empty Node) 节点可用属性类型和消息的完整列表,请参阅 Empty node 2DEmpty node 3D

另请参阅

属性系统

属性类型

教程:创建反射

使用 Kanzi Studio 为节点启用点击手势